home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / Ascii-Ansi / AsciiConverterIBM<->AMIGA.LHA / CAM / CAM.man < prev    next >
Encoding:
Text File  |  1993-03-06  |  10.0 KB  |  233 lines
  1.  
  2.                $VER: German doc CAM V1.8d (06.Mar.93)
  3.  
  4. ===========================================================================
  5.  
  6. Ein  Giftware ASCII-Code-Konvertier-Utility geschrieben von Rainer Hess (c)
  7. Copyright 1990-93 bei Rainer Hess.  Alle Rechte vorbehalten.
  8.  
  9. Es  wird  keinerlei Gewährleistungspflicht für die vollständige  Funktions-
  10. fähigkeit  des  Programms  oder  der  Vollständigkeit  dieser Dokumentation
  11. übernommen.  Sie nutzen diese Software/Beschreibung auf eigenes Risiko.
  12.  
  13. ===========================================================================
  14.  
  15. Cam.Info:
  16. ---------
  17. CAM  (ConvertAmigaMS-Dos) konvertiert Amiga<->MS-Dos ASCII-Code zueinander.
  18. Kickstart/Workbench  2.x  (37.175)  oder  höher ist anzuraten, da sonst das
  19. Programm  nicht  ueber  Intuition  gesteuert  werden  kann.  Es stehen auch
  20. dadurch nicht alle Funktionen zur Verfügung!
  21.  
  22. Funktion (Schalter und Menues unter Intuition):
  23. -----------------------------------------------
  24.  
  25. Komment.(1-4): Fügt diesen Text vorher in die Datei ein.
  26.  
  27. Unt.Zeichen:   (Unterschiedliche Zeichen)
  28. ~~~~~~~~~~~    <Entferne (+0x00)>
  29.                  Entfernt  alle unübersetzbare ASCII-Zeichen einschließlich
  30.                  NULL-Bytes.
  31.  
  32.                <Nur CR/LF>
  33.                  Korrigiert nur  den  unterschiedlichen  Wagenrücklauf (CR)
  34.                  und Zeilenvorschub (LF) von Amiga und MS-Dos zueinander.
  35.  
  36.                <zu Space (0x20)>
  37.                  Alle  unübersetzbare  ASCII-Zeichen werden durch ein Leer-
  38.                  zeichen (Space) ersetzt.
  39.  
  40. Konvertiere:   <zu AMIGA-DOS>
  41. ~~~~~~~~~~~~     Konvertiert den ASCII-Text von MS-Dos nach Amiga-Dos.
  42.  
  43.                <zu MS-DOS>
  44.                  Konvertiert den ASCII-Text von Amiga-Dos nach MS-Dos.
  45.  
  46. Dateiart:      (nur aktiv wenn Menüpunkt 'Suffix bei Namen' angewählt ist)
  47. ~~~~~~~~~      Das   Eingabe-Filerequester   zeigt  nur  Namen  mit dem/den
  48.                entsprechenden Suffix an.
  49.  
  50. Laden:         Öffnet das Eingabe-Auswahlrequester.
  51. ~~~~~~
  52. Speichern als: Öffnet das  Ausgabe-Auswahlrequester.  Je nach Konfiguration
  53. ~~~~~~~~~~~~~~ "gleiche Namen" muß evtl. nur der Pfad ausgewählt werden. Im
  54.                anderen  Fall  ist  ein  Name einzugeben oder eine Datei die
  55.                überschrieben werden soll anzugeben.
  56.  
  57. Kommentare (an/aus): Fügt  bei  Stellung "ein" die Kommentare am Beginn der
  58. ~~~~~~~~~~~~~~~~~~~~ Datei ein.
  59.  
  60. Datum:         Fügt  das  aktuelle Datum und Uhrzeit in den Kommentarstring
  61. ~~~~~~         ein.    Achtung   aktualisert   wird   nur  nach  vorheriger
  62.                Betätigung   des   Schalters,  etwa  nachfolgende  Benutzer-
  63.                definierte Zeichen werden gelöscht!
  64.  
  65. Konvertieren:  Startet den Konvertiervorgang.
  66. ~~~~~~~~~~~~~
  67. Kommentare:    <Aktivieren>
  68. ~~~~~~~~~~~       Setzt den Cursor in das erste Eingabe-Feld.
  69.  
  70.                <Zurücksetzen>
  71.                   Fügt den Originaltext, wie nach dem Programmstart, in die
  72.                   Eingabe-Felder ein.
  73.  
  74.                <Alles löschen>
  75.                   Löscht  den  Inhalt der Eingabe-Felder.  Je nach Wahl der
  76.                   Dateiart   werden   dateispezifische  Zeichen  eingefügt.
  77.                   Unter  Dateiart  'Text'  sind keine vorgesehen, hier wird
  78.                   wirklich  alles  gelöscht.  Bei Bedarf auf diese Dateiart
  79.                   zurückgreifen.
  80.  
  81. ZOOM-Gadget:   Verkleinert/Vergrößert das CAM-Fenster.
  82. ~~~~~~~~~~~~
  83.  
  84. Funktion unter Shell/CLI:
  85. -------------------------
  86. EINGABE:  cam FileName -Flags[a/m/al/ml]
  87.                  oder
  88.           cam >EingabeDatei AusgabeDatei -Flags[a/m/al/ml]
  89.  
  90. -m  = ASCII-Zeichen von AMIGA-DOS nach MS-DOS wandeln.
  91.  
  92. -a  = ASCII-Zeichen von MS-DOS nach AMIGA-DOS wandeln.
  93.  
  94. -ml = wie m, nur nicht übersetzbare Zeichen als Leerzeichen ausgeben.
  95.  
  96. -al = wie a, nur nicht übersetzbare Zeichen als Leerzeichen ausgeben.
  97.       Bei -a oder -m nicht übersetzbare Zeichen löschen
  98.  
  99. -i  = öffnet  bei einem Shell start unter Kick 2.x oder höher das Intuition
  100.       Fenster.
  101.  
  102. Beispiel: "CAM xy.dat -ml" wandelt Datei "xy.dat" von Amiga-Dos nach MS-Dos
  103.           Ausgabe erfolgt auf den Bildschirm.
  104.  
  105. Konfiguration von CAM (Funktion nur in Verbindung unter Intuition!):
  106. --------------------------------------------------------------------
  107. Überschreiben prüfen: Gibt eine Requestermeldung aus wenn eine gleichnamige
  108.                       Datei  schon existiert um ein Überschreiben der Datei
  109.                       evtl. zu vehindern.
  110.  
  111. Gleiche Namen:        Im  Zielpfad  wird  der gleiche Name wie vom Original
  112.                       genommen.   Resultierend  daraus muß der Zielpfad vom
  113.                       Originalpfad unterscheiden.
  114.  
  115. Suffix bei Namen:     Es werden nur Dateien angezeigt die dem Suffix  unter
  116.                       Dateiart zugeordnet sind.
  117.  
  118. Enferne  SUB=0x1A:    Entfernt  das  ASCII-Zeichen  SUB (26) aus der Datei.
  119.                       Nur aktiv wenn wenn MS-Dos zu Amiga konvertiert wird.
  120.                       Viele MS-Dos Editoren haengen dieses Zeichen ans Ende
  121.                       der Datei, beim Amiga stoert dieses Zeichen meistens.
  122.  
  123. Konfig speichern:     Speichert die aktuelle Konfiguration nach Verzeichnis
  124.                       ENVARC:   und ENV:  unter dem Namen CAM.prefs.  Diese
  125.                       Konfiguration steht somit auch nach einem Systemreset
  126.                       wieder zur Verfügung.
  127.  
  128. Konfig verwenden:     Sichert die aktuelle  Konfiguration  nur in ENV: d.h.
  129.                       diese   Konfiguration   bleibt   bis   zum   nächsten
  130.                       Systemreset erhalten.
  131.  
  132. Sollte   noch  keine  Konfigurationsdatei  in  ENV:/ENVARC:   bestehen,  so
  133. verwendet CAM die Standartwerte.
  134.  
  135. In eigener Sache:
  136. -----------------
  137.     Wenn  Ihnen  das Programm gefällt und Sie es verwenden wollen, so bitte
  138. ich  mir  für  den Programmieraufwand eine kleine Entschädigung zukommen zu
  139. lassen.   Da ich es unter Gift-Ware (Geschenk) deklariert habe, muß es sich
  140. nicht  unbedingt um Geld handeln z.B.  Bilder, Programme (kein BASIC, läuft
  141. auf  Kickstart/workbench  2.x  nicht!),  oder  was Ihnen eben sonst schönes
  142. hierzu  einfällt.   Bei Programmen:  KEINE RAUBKOPIEN!!!  Wenn es nicht von
  143. Ihnen  selbst  geschrieben  ist,  muß ersichtlich sein von wem das Programm
  144. stammt  (Kopierrechte).   Sollte Ihnen das immer noch zu viel sein, so wäre
  145. ich  aber  auch  schon  über  eine  kleine  Postkarte/Brief  oder ähnlichem
  146. dankbar,  einfach um zu wissen ob das Programm auch benutzt wird.  Personen
  147. die  Zugang  zur  DFÜ  haben  können  mir aber auch nur eine EMail zukommen
  148. lassen.  :-))) Der Vorteil, diese User können darüber hinaus bequem von mir
  149. über Updates informiert werden.
  150.  
  151. Anschrift:   Rainer Hess
  152.              Ahornweg 10/1
  153.       W-7440 Nürtingen 7
  154.              Germany
  155.  
  156.       EMail: rhess@a3tnt.adsp.sub.org (CBMNET)
  157.              Rainer_Hess@turttwo.tynet.sub.org
  158.  
  159.       voice: ++49-(0)7022-51713
  160.  
  161. P.S.   Sollte  Sie  Fehler, Verbesserungen, Probleme oder sonstiges auf dem
  162. Herzen haben, so lassen Sie es mich wissen.
  163.  
  164.   COPYRIGHT:   Das  Programm  darf  nur  von Privatpersonen genutzt werden.
  165. Eine  unentgeltliche  Weitergabe  ist  nur  von  Privat  zu Privat erlaubt,
  166. einschließlich  der  Verbreitung in privaten Datennetzen.  In jedem anderen
  167. Fall  der  Veröffentlichung  wenden  Sie sich an Ihre naechste Verbraucher-
  168. schutzzentrale und/oder auch an mich.
  169.  
  170. ---------------------------------------------------------------------------
  171.  
  172. History:
  173. --------
  174.     V1.1: Meldung eingebaut, nach welchem ASCII-Code konvertiert wird.
  175.           TRUE und FALSE eingefügt. printf und puts auf fprintf umgebaut,
  176.           so werden Fehlermeldungen auf dem Bildschirm ausgegeben und nicht
  177.           mehr in in die zu erzeugende Datei geschrieben, wenn mit Output-
  178.           Redirection gearbeitet wird. Thu Oct 18 13:22:25 1990
  179.  
  180.     V1.2: Auf Deutsche und Englische Version umgebaut. Versions-String nach
  181.           AmigaDOS OS/2 (Kick/WB 2.0) eingebaut.
  182.           Wed Jan 29 19:03:22 1992
  183.  
  184.     V1.3: Datenfelder vom Typ char auf (UBYTE) geändert. Unbedingt mit -cu
  185.           compilieren, UBYTE alleine brachte keinen Erfolg. Habe ich aber
  186.           gelassen, da dies "richtiger" ist. Wird bei SAS/C V5.10b ohne -cu
  187.           compiliert, so funktioniert Konvertierung nicht richtig, da dann
  188.           die Zeichen von -127 bis +127 gehen, es wird aber von 0 - 256
  189.           benötigt! Intuition-Oberfläche für OS/2. Darunter geht nur die
  190.           Shell-Version!
  191.           Mon Mar 30 00:44:43 1992
  192.  
  193.     V1.4: Reset Config wieder entfernt. Auf öffentliche Anfrage (DFÜ)
  194.           konnte mir keiner sagen wie ich den Checked-Haken von sichtbar
  195.           wieder zurücksetzen kann, wenn Menüs unter gadttols.library
  196.           erstellt sind.
  197.           Mon Oct 12 12:06:42 1992
  198.  
  199.     V1.5: Verrsionstring mit BumpRev erzeugt (in cam.h), dadurch "altes"
  200.           cam.h" zu cam_header.h umbenannt. Enforcer-Hits aus der Shell/
  201.           CLI-Version endlich beseitigt. BusyPointer eingefügt.
  202.           Sat Oct 17 03:02:40 1992
  203.           Versionstring geändert Aboutrequester eingefügt.
  204.           Sun Nov 29 19:48:25 1992
  205.  
  206.     V1.5: (04.01.1992) Optische Ausgabe des Konvert-Requesters geändert
  207.           Mon Jan  4 15:07:35 1993
  208.  
  209.     V1.6: Ein- und Ausgabe-Requester beim Programmstart allokieren, damit
  210.           Pfad erhalten bleibt und nicht immer wieder auf Standartwerte
  211.           zurueckgesetzt wird. Bug bei Aufruf der GUI von der Shell
  212.           behoben. Konvertier-Fenster über Taste 't' abzubrechen.
  213.           Mon Feb  8 15:31:19 1993
  214.  
  215.     V1.6: (12.02.93) Wenn mit run CAM von der Shell mit -i (GUI) gestartet
  216.           wurde, wurde ein Return-Error mit 10 zurueckgegeben anstatt 0.
  217.           Fri Feb 12 14:01:30 1993
  218.  
  219.     V1.7: Konvertiere-Gagdet jetzt gesperrt wenn nicht bei In- und Output-
  220.           Filerequester eingegeben ist.
  221.           Fri Feb 19 14:17:04 1993
  222.  
  223.     V1.7  (23.02.93) Schreibfehler in Deutschen Menu-Punkt aktivieren
  224.           geändert. Tue Feb 23 17:06:33 1993
  225.  
  226.     V1.8  Dateiart bei Anwahl 'Suffix bei Namen' nicht sperren. WaitPointer
  227.           aktiv wenn ein FileRequester oder das Konvertierfenster geöffnet
  228.           ist und Fenster so lange sperren.
  229.           Fri Mar  5 19:21:25 1993
  230.           Menuitem Konvertieren sperren/freigeben wie bei Konvertieren
  231.           Gadget.
  232.           Sat Mar  6 00:02:50 1993
  233.